<html>

<head>
<meta http-equiv=Content-Type content="text/html; charset=UTF-8">
<meta name="Author" content="Michael Margraf">
<title>Qucs - Формат схемного файла</title>
</head>



<body>
<a name="top" id="top"></a>

<center><h3>
- Qucs -<br>
Почти универсальный симулятор цепей<br>
</h3>
<h1>
Формат схемного файла<br><br>
</h1></center>

В этом документе описывается формат схемного файла Qucs. Этот формат используется 
для схем (обычно с расширением ".sch") и для просмотров данных (обычно с 
расширением ".dpl"). В следующем тексте приводится краткий пример схемного 
файла. 
<br><br>

<tt><small>
&#060;Qucs Schematic 0.0.6&#062; <br>
&#060;Properties&#062; <br>
  &nbsp;&nbsp;&#060;View=0,0,800,800,1,0,0&#062; <br>
&#060;/Properties&#062; <br>
&#060;Symbol&#062; <br>
  &nbsp;&nbsp;&#060;.ID -20 14 SUB&#062; <br>
&#060;/Symbol&#062; <br>
&#060;Components&#062; <br>
  &nbsp;&nbsp;&#060;R R1 1 180 150 15 -26 0 1 "50 Ohm" 1 "26.85" 0 "european" 0&#062; <br>
  &nbsp;&nbsp;&#060;GND * 1 180 180 0 0 0 0&#062; <br>
&#060;/Components&#062; <br>
&#060;Wires&#062; <br>
  &nbsp;&nbsp;&#060;180 100 180 120 "" 0 0 0 ""&#062; <br>
  &nbsp;&nbsp;&#060;120 100 180 100 "Input" 170 70 21 ""&#062; <br>
&#060;/Wires&#062; <br>
&#060;Diagrams&#062; <br>
  &nbsp;&nbsp;&#060;Polar 300 250 200 200 1 #c0c0c0 1 00 1 0 1 1 1 0 5 15 1 0 1 1 315 0 225 "" "" ""&#062; <br>
    &nbsp;&nbsp;&nbsp;&nbsp;&#060;"acnoise2:S[2,1]" #0000ff 0 3 0 0 0&#062; <br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#060;Mkr 6e+09 118 -195 3 0 0&#062; <br>
  &nbsp;&nbsp;&#060;/Polar&#062; <br>
&#060;/Diagrams&#062; <br>
&#060;Paintings&#062; <br>
  &nbsp;&nbsp;&#060;Arrow 210 320 50 -100 20 8 #000000 0 1&#062; <br>
&#060;/Paintings&#062; <br>
</small></tt>
<br><br>

В файле несколько разделов. Все они объясняются ниже. Каждая линия состоит из не более чем одного информационного блока, начинающегося знаком "меньше" ("&#060;") и заканчивающегося знаком "больше" ("&#062;").

<br>
<h3>Properties</h3>
Первый раздел начинается с "&#060;Properties&#062;" и заканчивается
"&#060;/Properties&#062;". Он содержит свойства документа, находящегося в файле. Каждая строка необязательна. Поддерживаются следующие свойства: 
<br>
<ul>
<li><em>&#060;View=x1,y1,x2,y2,scale,xpos,ypos&#062;</em> содержит положение 
в пикселах окна схемы  (первые четыре числа), его текущий масштаб и текущее 
положение верхнего левого угла (два последних числа).</li>
<li><em>&#060;Grid=x,y,on&#062;</em> содержит шаг сетки в пикселах (первые два числа) и включена сетка (последнее число = 1) или выключена (последнее число = 0).</li>
<li><em>&#060;DataSet=name.dat&#062;</em> содержит имя файла набора данных, связанного с этой схемой.</li>
<li><em>&#060;DataDisplay=name.dpl&#062;</em> содержит имя файла со страницей просмотра данных, связанной с этой схемой (или имя схемного файла, если этот 
документ является просмотром данных).</li>
<li><em>&#060;OpenDisplay=yes&#062;</em> содержит 1, если страница показа данных открывается автоматически после моделирования, в противном случае - 0.</li>
</ul>

<br>
<h3>Symbol</h3>
Этот раздел начинается с "&#060;Symbol&#062;" и заканчивается
"&#060;/Symbol&#062;". Он содержит элементы рисования, составляющие схемное обозначение для файла. Это обычно используется только для схемных файлов, 
которые считаются подсхемой.

<br>
<h3>Components</h3>
Этот раздел начинается с "&#060;Components&#062;" и заканчивается
"&#060;/Components&#062;". Он содержит компоненты цепей схемы. Формат строки: 
<br>
<em>&#060;type name active x y xtext ytext mirrorX rotate "Value1" visible "Value2" visible ...&#062;</em>
<br>
<ul>
<li>"type" ("тип") означает компонент, например, "R" для резистора, "C" для конденсатора.</li>
<li>"name" ("имя") - уникальное обозначение компонента на схеме, например, "R1" для первого резистора.</li>
<li>"1" в поле "active" ("активный") показывает, что этот компонент активный, то 
есть используется в моделировании. "0" показывает, что он неактивный.</li>
<li>Следующие два числа являются x и y координатами центра компонента.</li>
<li>Следующие два числа являются x и y координатами верхнего левого угла текста компонента. Они отсчитываются от центра компонента.</li>
<li>Следующие два числа указывают на  зеркальное отображение относительно оси x 
("1" - зеркальное отображение, "0" - нет зеркального отображения) и вращение 
против часовой стрелки (кратно 90 градусам, то есть 0...3).</li>
<li>Следующие параметры являются значениями свойств компонента (в кавычках), за которыми следует 1, если это свойство видимо на схеме (в противном случае 0).</li>
</ul>

<br>
<h3>Wires</h3>
Этот раздел начинается с "&#060;Wires&#062;" и заканчивается
"&#060;/Wires&#062;". Он содержит проводники (электрическое соединение  между компонентами цепи), их метки и  узлы. Формат строки: 
<br>
<em>&#060;x1 y1 x2 y2 "label" xlabel ylabel dlabel "node set"&#062;</em>
<br>
<ul>
<li>Первые четыре числа являются координаиами проводника в пикселах: 
x-координата начальной точки, y-координата начальной точкиt, x-координата 
конечной точки и y-координата конечной точки. Все проводники должны быть 
либо горизонтальными (обе x-координаты равны), либо вертикальными (обе 
y-координаты равны).</li>
<li>Первая строка в кавычках - имя метки. Она пустая, если пользователь не 
установил метку на этот проводник.</li>
<li>Следующие два числа - x- и y-координаты метки или ноль, если метки не существует.</li>
<li>Следующее число является расстоянием между начальной точкой проводника и 
точкой, где на проводнике установлена метка.</li>
<li>Последняя строка в кавычках - параметры цепи проводника, то есть 
начальное напряжение узла, используемое ядром симулятора для поиска решения. 
Эта строка пустая, если пользователь не установил параметры узла цепи для 
этого проводника.</li>
</ul>

<br>
<h3>Diagrams</h3>
Этот раздел начинается с "&#060;Diagrams&#062;" и заканчивается
"&#060;/Diagrams&#062;". Он содержит диаграммы с их графиками и маркерами. 
<br>
<em>&#060;x y width height grid gridcolor gridstyle log xAutoscale xmin xstep xmax
          yAutoscale ymin ystep ymax zAutoscale zmin zstep zmax xrotate yrotate zrotate
	  "xlabel" "ylabel" "zlabel"&#062;</em>
<br>
<ul>
<li>Первые два числа - это x- и y-координаты нижнего левого угла.</li>
<li>Следующие два числа - ширина и высота границ диаграммы.</li>
<li>Пятое число равно 1, если сетка включена, и 0, если сетка выключена.</li>
<li>Дальше идет цвет сетки в виде 24-битного шестнадцатиричного RGB значения, например, #FF0000 - красный.</li>
<li>Следующее число определяет стиль сетки.</li>
<li>Следующее число определяет, какие оси имеют логарифмический масштаб.</li>
<li></li>
</ul>

<br>
<h3>Paintings</h3>
Этот раздел начинается с "&#060;Paintings&#062;" и заканчивается
"&#060;/Paintings&#062;". Он содержит элементы рисования, которые используются 
в схеме. 

<br><br><a href="#top">наверх</a><br>
</body>
</html>
